Chapter 2 

SYSTEM CONFIGURATIONS 


Th is chapter contains general r u 1 e s governing the attachment and 
powering of various configurations. The r e a s on s for the procedures 
s h o u 1 d be apparent from the explanations given in this chapter, but 
if the reasons are not apparent a more complete explanation of 
the princip1 e s of Operation mag be consulted in APPENDIX 11. 

Communication between a peripheral and the Computer must conform to 
the limitations imposed by the Hardware. Tor example, the speed of 
comunication is aluays limited. The limitations are different for 
different peripher als. The Computer must "knoui 11 wh a t peripheral it 
is communicating with and how to compose and interpret messages to 
and from that peripheral. Some of the Information about the 
peripheral that permits the Computer to handle it is in Computer 
memory, but initially comes from different sources. For example, 
the dis'nette and the disk drive are the source of information for 
handling communications with the disk drive. This information is 
passed to Computer memory wh en the Computer console is powered ont 
provided the disk drive is already powered on and contains an 
appropriate diskette. 

Information about the serial ports of the ATARI 350 Interface Module 
is contained in the Interface Module itself and is transferred to 
Computer memory when the Computer console is powered on. Therefore, 
you must power on the Interface Module before you power on the 
console^ if you intend to use a serial port. 

You may unnecessari1y boot the Interface Module. That is, you may 
turn on the Interface Module then the Computer console, but not use a 
serial port. This does no barm, but it "wastes" RAM <1762 bytes) by 
loading the unused RS-232-C handler. 

You may wish to use the Interface Module to int-erface to a n on-ATARI 
device. In that case, you must make sure that the device is compatible 
with the Interface Module. You must examine the spec i f i cations of 
your device. You may also have to make or specify a cable to connect 
the Interface Module with your device, and APPEND IX 11 contains guide- 
lines and connector information on this subject. 


Hoo k~up 

The general rule; order of hook~up, in itself, has no importance. 
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Simply hooking up a peripheral to the Interface Module has no effect 
on its Operation and is not recognized by the System. It is only when 
the peripheral is powered on that it has any effect. To have an f 

effect# the peripheral must be powered on. However# an effect# once i 

exerted by having a powered peripheral# is not rteeessarily canceled by 
turning the power off or disconnecting the hook-up. What is 
important- as a general rule. is the sequence of powering up the 
various components of the System. 

P ouiei—up 


You should turn on the power to any peripheral that you intend to 
ose before you turn on the power to the console, This general rule 
has exceptions which will result in your taking a pointless pre- 
caution. For example# the S25 Printer can be powered on at any time, 

When the Interface Module and a Disk Drive are in your System# they 
will both have to boot up before they can be used# so they both have 
to be powered on before you power on the console. All of the ATARI 
Disk Operating Systems# except DOS I# are compatible with the RS—232-C 
handler in the Interface Module. 

If you have DOS I# you cannot use the Disk Drive with the Interface 
Module. You should obtain DOS II (or a later DOS). 

If you have DOS II (or a later DOS)# power up the Disk Drive before 
the Interface Module. 

If you have a non-ATARI DOS# there is no assurance that it will 
operate the Disk Drive with or without the Interface Module. You 
must consult the DOS documentation for guidance. 
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Configurations Using Onlg the Printer Pdt t of 


Turn on the Computer console before the Interface Modul«, sine« the 
Interface Module does not need to be booted in order for the Computer 
to access the Frinter Port, but the Interface Modul« must be powere* 
on in order to transfer communication between the Computer and the 
Printer. The printer handler i« in the Computer Operating System, not 
in the Interface Moduls ROM. 


IF YOU HAVE MORE THAN ONE ATARI PRINTER 


You mau connect two ATARI Printers to the Computer at the same time. 
However, the printer handler built into the Operating System can 
control only one printer at a time. Therefore, to avoid errors, make 
sure you turn the power on to only one printer at a time. 


You may switch printers at any time, even with the Computer turned on. 

If you have no printer c onnec ted to the ATARI S50 Interface Mod ule 
parallel printer port, or if that printer is turned off, then the 
Interface Moduls will not act like a printer, and you may use another 
printer connected to the System. 
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Configurations Using only the Modem With the ATARI 850 Interface 
Module 


You must have an appropriate Cartridge in the console (e.g./ 

TeleLink I) and you must power on the Interface Module before the 
console. With TeleLink I, you may not use a Disk Drive. 

If you are using a Disk Drive as well as the Modem (with a compatible 
cartridge)/ the DOS on the diskette in the Disk Drive must be DOS II 
(or a later version. > DOS I is not compatible with the Interface 
Module. You must refer to the documentation for the version of DOS 
that you are using. 

The ATARI 830 Modem is acoustically coupled. Both input and output 
Signals are transformed into tones in the audible ränge, Conseguently/ 
the modern may respond to extraneous sounds in the environment, The 
rubbsr muffs cm the modern attenuate environmental soundsi but loud 
sounds or nearby percussive effect (such as tapping the table) are 
ciuite likely to be received and/or transmitted as (false) Signals. You 
should place the modern in a location to minimiie unintended effects of 
t his na ture. 
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fable 2.1 Power-up procedure with varioas common configurations 


System includes 
800, ATARI 850, 

400 or 
and 

Car trid g e 

DOS» 

Comments 

825 Printer 


Lang uage 

<BASIC, Assembly/ 
Editor, etc. ) 

No 

No restrictions 
on power-on 
sequence. 

830 Modem 


TeleLink T 

No 

Turn on ATARI 

850, then 
consol e. 

825 Printer 

310 Disk Drive 


Lang uag e 

Yes 

Turn on 810, then 
console, then 

ATARI 850. 

Position of 825 
in sequence does 
not matter. 

825 Printer 

830 Modem 


TeleLink t 

No 

Turn on ATARI 

850, then 
console. Position 
of 825 in se- 
quence does not 
matter. 

830 Hodem 

ATARI Disk Drive 

Lang uag e 

Ves 

Turn on ATARI 850 
and disk drive, 
then console 

825 Printer 

830 Hodem 


Lang uag e 

Yes 

Hake sure you 
have DDS II. 


810 Disk Drive 


Note: DDS reauires a machine with 16K RAH. The amount of RAH Ieft 

for your BASIC program is 16K less the RAM required for OS 
(about 3K>, Interface Hodule handler (1762> and BASIC (about 
8K>. The RAH used by DDS can be determined exactly by 
performing PRINT FRE(O) with and without DDS loaded—the 
difference in the numbers printed is the DOS siie. 


i 


J 
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Ch ap ter 3 
SERIAL PORTS 


The configuration and ui» of serial ports is a comp lex matter. You 
must keep in mind a large number of details and you must ob s er ve 
complicated procedures exactly, We have tried to reduce the amount of 
technical detail in this chapter, giving only sufficient detail to 
Show the structure and effect of commands and how they re late to each 
other, The supportive detail u/i 11 be found in the Appendices. Ünce you 
are familiär w i t h capabilities of the Interface M o d u 1 e. you will 
probably make most freqeuent reference to the Appendices. \NEED 
9;SPACE 5 OverView 

The RS-232-C Standard defines a ränge of values of parameters of a 
communication link. This i$ described rr.ore fully in APPENDIX 1. The 
ATARI ATARI 850 Interface Moduls is the device used in ATARI Personal 
Computer Systems to set the values of these parameters. The Interface 
Moduls organizes the bit stream of communication according to the 
software-coded intructions. 

When we refer to a communication port as an R5-232-C port, we mean 
that Signals to/from that port conform to the RS-232-C Standards. We 
also use the adjective " R S-232-C-c omp a t i b 1 e when the communication 
conforms to essential aspects of the RS-232-C Standard/ with the 
implication that the channel may lack some features of the Standard 
and may in- corporate other features not included in the Standard. 
Perhaps the most important aspect of the Standard is the specification 
of voltage levels corresponding to mark and space. Accordingly/ many 
other publicatior.s may use the term "RS-232-C-c omp a t i ble" to mean 
11 using the voltage levels in the RS-232-C Standard", 

Using Software instructions to set the particular Standard or 
"protocol" is called "configuring the port". In configuring the port 
you may set the following: 

Baud 

Number of bits per word sent/received 
Number of stop bits per word sent 

Whether the incoming control signals DSR, CTS and CRX are 
monitored 

Whether input parity is checked 
Whether output parity is set 

Whether Line Feed is added after every Carriage Return sent 
Translation of the word being sent or received (3 types of 
trans1ation) 

Whether the outgoing control signals DTR. RTS are used 

These are shown as three groups. corresponding to the three 
configuration commandsi otherwise. the division into groups is 
arbitrary . 
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Default Conditions 


If you da not configure the port, the System sets default values of 
the port variables, as follouis: 

300 Baud 
8 b i t s per word 

1 stop bit per word transmitted 
Input parity is not checked 

Output parity bit most significant bit (bit 7) is set to zero 

Linefeed is not added after every Carriage Return 
Light-trans1ation (see APPENDIX 6) 

Outgoing control signals DTRi RTS are not set. 

Each of tbese groups of conditions can be changed ulith a config- 
uration c ommand. 


Limitations on Port Configurations 

The ports have different signals available. as sh own in Table 2.2 
Table 2.2 Available signals on ports 1» 2i 3 and 4 


PORT 1 

PORT 2, 3 

PORT 4 

DTR 

DTR 

XMT 

RTS 

XMT 


XMT 




DSR DSR RTS 

CTS 

CRX 


If you are using the modern set for Half Duplex* connected to a port of 
the Interface Mod ule, then the port when outputing must be configured 
for Block Output and when inputing must be configured for Concurrent 
Mode I/O at not more than 300 Baud. 

Gther limitations on port configurations are imposed by using a port 
in the concurrent I/O mode. These limitations are described in the 
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follotuing section under the heading of Warnings and R e s tr i c t i ons. 


Confi 9 urations « j> ith 5-, 6 —, and 7-bit uiords are subject to 1 imitatiuns 
in other I/O parameters; these are described in the section on BASIC 
I/O Statements, GET, INPUT, PUT and PRINT. 


Mode—Block Output or Concurrent I/O 

There are two different modes of using the a port, called BLOCK 
OUTPUT and CONCURRENT I/O. 

Block Output: 

Block output is used only for output from the Computer to the ATARI 
850 Interface Module. A block output is effected by the BASIC 
commands PRINT and PUT to a properly OPENed port, 

PRINT 33-byte 32-byte blocks ATARI 850 RS-232- 

or ->BUFFER -> ->c ompa t ib 1 e 

PUT d evic e 

The contents of the Buffer can be sent at any time (befere it fills) 
by the Command FORCE SHORT BLOCK, described in the section called 
Forcing Early Transmission of Output Blocks. 

Concurrent I/O Kode: 

To receive Information from the ATARI 850 Interface Module you must 
use this mode. It Supports full duplex communication with the 
Interface Module, To use this mode, first OPEN a file for I/O then 
give the START CONCURRENT I/O MODE command (XIO 40), then use the 
BASIC commands INPUT, GET, PRINT or PUT. In this mode, BASIC is 
executing other instructions uhile I/O is proceeding, Incoming 
characters from a port are stored in a buffer. You may get the 
contents of the buffer at any time by INPUTing from that port. 

Warnings and Restrictions 

You must observe certain precautions uihen you use Concurrent Mode 
I/O. The only I/O opeations that are permitted with this mode are 
GET, INPUT, PUT, PRINT, STATUS and CLOSE to the OPENed port, and 
I/O to the Keyboard and Screen (uhich do not involve any peripheral 
device >. 

Using one Port for concurrent I/O prevents the use of any other Port 
of the Interface Module, including the Printer Port. The other ports 
remain inaccessible until you terminate the concurrent I/O mode. You 
terminate concurrent I/O by CLQSEing the port. 

Düring Concurrent I/O, incoming data may overflow the conputer 's 
buffer. In that case, data is lost. Methods for avoiding loss of 
data in this way are described in APPENDIX 8 . 
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^Tmcst l. «f.cut.db.fore J START CONCURRENT »ODE I/O co™».nd. 

onc, «•"«•“r:‘/ 0 ^;‘"; r :iii n ; o UTS^ESSr"n' l ?i:. eh c™p'üt!i , ‘ 

üiith an ap propr late command. Pressi 9 de ^ ult value. Turning 

c onsole will NOT reset an« P Module mag resst some perameters but 

s:;: ;.i o .T„-°^ h :.; n u irtr;.cu... ; 

: h s:s u!: M ” s:^ n ; • -;? v :s - h ”v.*- 

Session uith the Computer is not recommendej. 


during a 


Interface 


Turning off the power to the Computer also an d the Interface Module 
Module. When gou turn the Computer ' in APPENDIX 

a uto-b oots (see the »ction ?"«*?"*■' v ° to their pre-set 

11), all of the above parameters will have rtveri 

default values. 


Configuring a Port 


If „ a default condition i. t. b,• S »‘".I»"'' 

before it is used. Configuring a P or * ”/“ H^ee pr inc i pa 1 
are presented in the Appendices. 




uih i c h , o f 
y ou must put it 

- » . ■ . K ä. ho ' ctarT CONCURRENT I/O command. Thus, 

into concurrent I/O mode with the START CüNCUKK C0(Timand , lt is 

the START CONCURRENT I/O command is * in that the port to 

different from the other »nfiguration ojjandj ^ »J ^ ^ ^ h 

which it applies must be OPENed a d y DU s hould think of the 

complex than other confi guration command ^ at i on command in 

START CONCURRENT I/O mode c J f * e “ s 0 n other aspects of 

one aspect, and as havmg more lffl ?" f por t,. 

using the configured port, and, mdeed, all P 


Setting the Eaud, wor d si ie, 


stop bits and ready monitormg 


Format' XIO 36, «Channel, Auxl. Aux2, ,,R n 
Example: XIO 36, #1, 139, 6, "R: " 


Th i s c ommand 
transmitted 


in 


sets the Baud rate, Word siie, 
It also Controls 


messag es. 


control signals. 


and nutnber of 
the monitoring 


stop bits 
of incoming 


K 
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Channel is the number of the Channel that BASIC coititnands for this 
p or t must use. 

Auxl is coded to specify 3 variables—Baud, uord size and the number 
of stop bits. The coding is given in Tables li 2 and 3 in APPENDIX 5. 

Aux2 is coded to specify tuhich of the incoming control signals should 
be checked. These signals are DSR (Data Set Ready), CTS (Clear to 
Send) and CRX (Carrier Detect). The coding is given in Table 4 of 
APPENDIX 5. 

Rn: is the port being configured. n is 1, 2, 3 or 4. R: is interpreted 
as RI: 


Setting Translation Modes and Parity 

Format: XIG 33, «Channel, Auxl, Aux2, "Rn:" 

Example: XIO 38, #2, 64, 33, "R2: " 

Th is c ommand sets the various aspects of translation of message coding 
b e tween. 

38 specifies this I/O command. 

Channe1 is the number of the Channel that BASIC commands for this port 
must use. 

Auxl is coded to specify the translation mode, input parity mode, out¬ 
put parity mode and whether a Linefeed is added after Carriage Return. 
The coding is given in Tables 1, 2, 3 and 4 of APPENDIX 6. 

Aux2 is the number eq.uivalent to the "uon't translate" charaeter in 
one translation mode. See APPENDIX 6. 

"Rn:" is the port being configured. n is 1, 2, 3 or 4. "R:" is 

interpreted as "RI: " 


Controlling the Outgoing Lines DTR, RTS and XMT 

Format: XIO 34, «Channel, Auxl, Aux2, "Rn:” 

Example: XIO 34, #2, 160, 0, "RI:" 

This command determines the use of XMT and the outgoing control lines 
DTR, RTS. 

34 specifies this I/O command. 
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Channel is the number of the Channel that BASIC commands for this port 
must use. 

Auxl is coded to specify control of DTR, RTS and XMT. The coding is 
given in Tables 1. 2 and 3 of APPENDIX 7. 

Aux2 is not used by this command. It mag be sefc to zero. 

"Rn: 11 is the port being configured. n is li 2, 3 or 4. N R: M is 
interpreted as "Ri: " 


Using a Port 

This section describes the use of a port/ including the instructions 
OPEN, CLOSE, and the BASIC I/O commands GET, INPUT, PUT and PRINT, 
LIST, SAVE. These commands should all be familiär to you from your 
previous use of BASIC. 

Tuo neu commands, specific to RS-232-C ports, are described, namely, 
START CONCURRENT I/O (XIO 40) and FORCE SHORT BLOCK (XIO 32). 

The use of the STATUS command is also described in this section. The 
command should be familiär from your previous use of BASIC, but the 
Information that you can obtain about an RS-232-C port by using the 
STATUS command is, of course, neu. 


Opening an RS--232-C Port 

You must OPEN a channel to an RS-232-C port before you can read from 
it, urite to it, start concurrent mode I/O or read its status. You 
may configure a port uithout having opened it. 

The OPEN command in BASIC is: 

OPEN »Channel, Auxl, Aux2, "Rn:" 

Channel is the number of the channel that other BASIC commands for the 
opened port must use. Any channel number CI through 7) may be used. 

Do not use a channel if another file is already open through it. 

Auxl specifies the direction of the port: 

5 signifies that you are going to use the port for input only 
(concurrent mode) 

8 signifies that you are going to use the port for output only 
(block mode) 


9 signifies that you are going to use the port for output only 
(concurrent mode) 

13 signifies that you are going to use the port for input and 
output (concurrent mode) 

Aux2 is not used in this commandj make Aux2 zero. 

Rn is the RS-232-C port being opened. n is li 2, 3, or 4. R: is 
interpreted as RI: For a given port no more than one channel may be 
open at one time. 


Closing an RS-232-C Port 

Having OPENed and used a port. you may disconnect the channel by 
closing the port with the BASIC command CL.QSE, as follous: 

CLOSE #Channe1 

Channel is the channel number previously ÜPENed. 

CLOSE is also used to terminate concurrent mode I/O. In this case 
the channel number is that one through which the concurrent mode 
I/O is active. CLDSE is the only tuay to terminate concurrent mode 
I/Ofromaprogram. 

To restart concurrent mode I/O to the porti you must first re-QPEN 
a c hanne 1 to it. 

When you CLOSE the channeli all data in the input buffer is lost» 
and all data in the output buffer is sent. 

Closing a file does not change the configuration of the channel, 

You may change any configuration Parameters after closing the port. 

FAILURE TO TERMINATE CONCURRENT MODE I/O PRDPERLY BEFORE ATTEMPTING 
I/O TO QTHER PERIPHERALS (OR EVEN OTHER RS-232-C PORTS) WILL PRDBABLY 
RESULT IN PROGRAM FAILURE. THE ONLY WAY TO RECDVER FROM SUCH FAILURE 
IS BY TURNING THE COMPUTER OFF THEN DN AGAIN, WHICH RESULTS IN THE 
LÖSS OF INFORMATION IN MEMORY. 

Pressing SYSTEM RESET on the Computer console closes all open channels 
and re-estab1ish es the I/O system's registers and pointers. This 
method of closing files results in the loss of data being held in 
input and output buffers, The Interface Module may be ° interrupted" 
by the SYSTEM RESET and so transmit only part of the character being 
sent at the time SYSTEM RESET was pressed, Another possible effect 
of SYSTEM RESET is a short burst of random data to an active con— 
current mode RS-232-C port. 
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The exclusion of peripheral I/O to anything other than the active 
concurrent mode I/O port applies to the CLOSE command, If you have 
any other peripheral device or RS-232-C port open/ gou cannot CLOSE it r 

uhile one open port is in the concurrent mode. 

If gou do not close files wi th CLOSE/ BASIC will close them when it 
interprets END or comes to the end of the program. However, gou do 
not know the order of the closing of files that BASIC will impose. 

BASIC will as likely as not close another channel before it closes 
the channel of the active concurrent mode I/O port. If it closes 
another channel first, your Computer will "die", just as it would ln 
response to any other attempt to perform I/O to a channel that is not 
the active concurrent mode I/O channel. 

Therefore, ALWAYS MAKE SURE THAT AN ACTIVE CONCURRENT MODE I/O 
CHANNEL IS CLOSED BEFORE ANY OTHER CLOSES CAN OCCUR. 


Starting Concurrent I/O Mode 

Format; XIÜ 40, #Channel, 0, 0, "Rn;" 

Example; XIO 40. fcll 0, 0, "Rn;" 

This command is used to start concurrent I/O mode. 

40 specifies this I/O command. 

Channel is the number of the Channel 

n is the port number 


Wi t h this command the input buffer is in the handler in the computer. 
The buffer holds 32 bytes. For some purposes a longer buffer is more 
convenient. APPENDIX 8 shows how to specify any siie of buffer. The 
BASIC coding is more complex. 


EASIC I/O Statements GET, INPUT, PUT AND PRINT 

The BASIC input Statements are GET and INPUT. The BASIC output 
statements are PUT and PRINT. Please refer to the BASIC Reference 
Manual for details about these statements. In this context, PRINT 
and INPUT must always include the proper channel number. The formats 
are given here as a reminder, 

Formats: GET #Channel,var 

INPUT #Channel<; Havar>ECavar>. . . 3 
>■£svar> C <svar>. , . 3 
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PUT #C hsnns1.ae*p 
PRINT #Charme 1C; > e x p L , e * p. 3 

-Cr > 

This s e c tion i s about h o w these statements are used w i t h the Serial 
Ports. Before reading this section you should read and understand the 
material on configuring the portS; including Appendices, and the 
sections on opening and closing ports and starting concurrent I/O. 

INPUT and PRINT are 1ine-oriented, They process a "line" of 
characters at a time. A line ends with an ATASCII EOL (End-of-Line) 
character. The translation mode you set up Cor the one pre-set for 
you) can be used to translate the EOL character to an ASCII CR 
(Carriage Return) on output) and CR to EOL on input. AN EOL IS 
REQUIRED FOR INPUT—THAT IS) A BASIC INPUT STATEMENT WILL NOT FINISH 

UNTIL AN EOL IS READ IN. I f your input does not have EOL) or if y our 

translate mode will not produce it on input) you should not use INPUT; 
use GET instead. 

Remember that if you place a comma or semicolon at the end of a PRINT 

command) EOL is not produced uhen the PRINT command is executed. 

When you use a BASIC input Statement/ the input data must be in the 
proper form for BASIC. For example/ if you read into numeric var¬ 
iables) the input must consist of digits with optional sign, decimal 
point/ and exponent. Multiple input numbers must be separated by 
commas. For more details see the BASIC REFERENCE MANUAL. 

GET and PUT are character-oriented. You can input or output only 
one character at a time. This is much slouter than INPUT and PRINTr 
but it gives you more control over wha t you send and receive. You 
may alternate between the different types of BASIC input statements, 
and between the output statements) to the same port if you need to. 

To do input and/or output) you must have opened a channel to the port 
and you must have specified the necessary in, out, and concurrent 
permissions when you opened the file (see the section about OPEN). To 
do input, you must also have started the concurrent I/O mode. 

Output may be done either in BLOCK MODE or in CONCURRENT MODE. When 
you do output in block mode, you MUST NOT start concurrent mode I/O 
before doing the output, For this reason, full duplex Operation is 
not allowed with block mode output. 

Block mode output sends your data out to the Interface Module in 32- 
character blocks (whenever 32 characters have been collected by the 
handler from your PUT or PRINT statements). The Interface Module 
then sends the characters over the RS-232-C port. The Computer waits 
tuhile the Interface Module sends the block over the RS-232-C port. 
Between blocks the Computer 's I/O port is not being tied up as it is 
when concurrent mode I/O is active, so if you use block mode there are 
no restrictions on usng other I/O devices at the 11 same time. " 
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Elock mode i s the on 1 y mode in wh i c h you can transmit 5-, 6- or 7-b i t 
ujords (ttie u/ord size option of the SET BAUD RATE command will not 
werk with concurrent mode output). B-bit words may be transmitted 
in either block or concurrent mode. 

NOTE: On rare occasions, the Operating System may resend a block to 

the Interface Modul e. This may result in part or all of the the 
block being sent twice to the RS-232-C peripheral. To avoid 
this problem, use concurrent mode output. 

Concurrent mode output does not wor k in blocks. Instead, wh enever 
your program tries to output any characters to the Interface Moduls, 
they are first moved into a 32-byte buffer. As long as there are any 
characters in the buffer which have not been sent they will be sent 
as fast as possible. This "draining" of the buffer takes place con- 
currently with execution of other BASIC statements in your program. 

The on1y time your program will be held up is when you try to output 
characters faster than they can be transmitted at the Baud rate you 
are using and the buffer fills up. Your program will be held up 
until space becomes available in the buffer. If you do not want your 
program to be held up you may use the STATUS command to find out how 
much buffer space you have used and let your program use that in- 
formation to decide whether or not to execute an output statement, 

Concurrent mode input may be used at the same time you are using con— 
current mode output (full duplex Operation). Note that block mode 
output is NOT all owe d if you do this. Also note that 5-, 6-, or 7- 

bit words can only be input in half-duplex mode. If you select any- 
thing other than B-bit words you cannot output and input them at the 
same time. 5-, 6-, and 7-bit words can be input at speeds up to 300 
Baud. 

Concurrent mode input data is placed in the input buffer as it is 
received from the RS—232—C port. Your program must get the data out 
of the buffer with GET or INPUT before the buffer fills or data will 
be lost from the buffer. If the buffer fills, the data that has been 
in the buffer the longest will be replaced by the newer data. What 
your program will see is that characters are missing. The STATUS 
REQUEST command will teil you if data has been lost this way. STATUS 
REQUEST can be used to find out how many characters are in the input 
buffer, so you can program the machine to decide when to do an INPUT. 
STATUS can also be used to determine same kinds of errors in data 
reception and parity, This is fully described in the section on the 
STATUS command. 


OTHER I/O COMMANDS FROM BASIC—LIST, SAVE, LOAD AND ENTER 

There are a number of BASIC statements which perform "compound I/O" 
operations. That is, their Operation can be thought of as consisting 
of combinations of the other I/O operations. These combinations are 
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hiiilf into BASIC s 0 you cannot cSiange the ways these statements work. 
n. it.t.m.nt. aK LIST, SAVE, LOAD and ENTER. <Not. t at aac of 
these statements inputs or Outputs part or all of « our DATA Qr 

unlike, say, the PRINT statement, which Outputs your program «DATA or 
variables. Th i s distinction is not important here; uihat u« 
looking at in this section is how these Statements u;ork «Kith the 
RS-232-C portsi not uihat data t h e y transfer. 

Each of these Statements can be thought of a s cons i st:ing of Mrst an 
QPEN. then one or more input or output op erat ion s, then a £LOSE. 

These operations do NOT include any c onr i gurat i on of RS-232 C P°rts, 

Ind theS do not include any START CGNCURRENT MODE I/O «tion Thus 
;! c anno t use the two input Statements (LOAD and ENTER u)i tb the 
po-ono-e oorts Instead, you may enter your program as data, to 

u »..ü. oasic, „„ *. ■ — 

terminal cartridge, and put the program on cassette or r d i * k 
you can ENTER the program to BASIC from the cassette or disk. 

Since the configuration commands may be executed uiithout opemng a 
Channel to an RS-232-C port, you can configure the Baud E t 

translation modes, and so forth, before you exacute a L !ST or SAVE to 
the port. (SAVEing a program to the R5-232-C port 'w111 *end 
program in BASIC'S internal 8-bit tokenned format —this will proba y 
on 1 y be useful if you are sending the program to f^ otheT J™* 
Computer.) Since LIST has no implicit Interface Moduls status 
checking, the program will simply be sent out at the maximum rate 
allotued^by the Baud rate you have selected. The receivmg device 
therefore be able to receive the data at that rate. 


FORCING EARLY TRANSMISSION OF OUTPUT BLOCKS 

If you are using the block output mode, your output characters wi i 1 
be place in a 32~byte buffer and transmitted: 1) when the 

fills up; 2) when you close the channel to the Rs232 port; 3) when 
CR (decimal 13) is placed in the buffer. 

On occasion, you may wart to force the «i'ding of the Information in 
the buffer. For example, if you have specified the Append LF trans 
late Option, the LF will be sent at a different time, la^ { 

CR. You may want to send the LF immediately if th ? * J4 J" C RX 

a terminal As another example, if you are using the DSR, CTS, or Chi* 
monitoring feature to avoid sending more characters to a de ^ c *J^ ari 
it can handle, you can use the FORCE SHORT BLOCK op era :1 ters 

uour characters one (or a few) at a time. By sending a feu characters 
at a time, you insure that the device stays ‘-ready 11 and properly 
receives all the characters sent to it. (See the overvieu) sectio , 
the Baud section, and the STATUS REQUEST section for more Information 
on the monitoring of DSR, CTS and CRX lines. ) 
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The FORCE SHORT BLOCK Operation is only valid if you are using block 
output mode. If you ave using concurvent mode, you cannot use this 
c ommand. 

If you issue a FORCE SHORT BLOCK command uihen the buffer is empty. no 
action will be taken. Doing this is not an error. Since you can 
alternate output to tuo RS-232-C ports when using block output mode, 
you can also alternate FORCE SHORT BLOCK commands from one port to 
another, The ports must be opened through different channels. of 
c ourse. 


The BASIC form of the FORCE SHORT BLOCK command is: 

XIO 32. #channel; Auxl. Aux2. "Rn:" 

32 specifies the FORCE SHORT BLOCK command. 

Channel is the channel through which you have OPENed the RS-232-C 
port. 

Auxl and Aux2 are ignored in this command. In generali you should 
specify i ero for them. 

Rn is the port mhose output buffer you are forcing, n is 1< 2; 3 or 4. 
R: is interpreted as RI: 

STATUS COMMAND 

The STATUS command is useful for determining many facts about an 
RS-232-C port and the state of the Interface Module. You can check 
for certain specific error conditions. to find out why certain errors 
have occurred; to check parity. and so on. The STATUS command allons 
you to determine the amount of data in the input and output buffers 
ujhile concurrent mode I/O is in effect. STATUS also allouis you to 
check the state of the RS-232-C control lines DSR; CTS; CRX (and the 
state of RCU at the tme you issue the STATUS command), 

The STATUS command may be issued only through a channel opened to an 
RS-232-C port. You may issue the command uhether or not concurrent 
mode I/O is in effect. If this mode is in effect to a port. you 
cannot obtain status Information (via the STATUS command) from another 
port. 

The information returned by a STATUS command is different according to 
uhether or not concurrent mode I/O is in effect. Uhen concurrent mode 
I/O is in effect. the STATUS command allous you to see hou full your 
input and output buffers are. but you cannot check on the state of the 
control lines DTR. CTS. CRX and RCV, (RCV can be directly checked. 
hotuever. by PEEKing at the computer / s serial I/O control register. ) 
When concurrent mode I/O is not in effect. you get no information 
about buffers. of coursei but the state of the control lines can be 
checked. There are other minor differences in the effect of the 
STATUS command in the two cases. 



Tn Ea c IC the STATUS REQUEST command is implemented as a 'Tompound" 
is. ,»« «ust c=d. »ultipl, BASIC stat^.nt, t. „st th. 
statua The first, of course, is the STATUS command. This is 
fuUoued hg uses of the PEEK function to retneve status which ts left 
in a small status area by the STATUS command, 

The STATUS command loofcs 1ike this in QASIC: 


STATUS ächannel, avar 


at the number itself to see if 
The STATUS command simplg puts 
number can be interpreted just 


Here, Schannel specifies the Channel (1-7) through which you have 
□PENed the RS-232--C port. You may issue this statement to the port 
before and/or arten concurrent mode I/O is started. 

Avar is a variable which will get the status OF THE STATUS STATEMENT 
ITSELF. That is, avar will be set to the input/output System s 
one-bytn status that is returned when BASIC calls the I/O System-*- 
since the I/O System call here is the STATUS, the value returned is 
the I/O sustem's determination about how the STATUS command uent. This 
run.be/is th. same Kind of number returned to BASIC by the I/D System 
after ANY I/O call, but in the other BASIC I/O Statements, BASIC looks 

the I/O was completedwithout error, 
the number in the avar. This status 
like one of the ERROR Codes for 

example, you will get 130 if you neglected to OPEN the channel, since 
an unopen IOCB does not specify any peripheral device and error 130 
means "Nonexist ent Device Specified”. The status number will be 1 if 
the STATUS call was completed without error. the status number will 
some error number greater than 127 if there was some problem with the 

STATUS call. 

If the STATUS call is successful, up to four bytes of Information are 
s t or e d in locations 746, 747, 74S, and 749 Location 746 . a ^“IJ" 

tains error status bits relating to the status historg of the RS 23* C 
port The other three locations will contain buffer uss Information if 
concurrent mode I/O is active. If concurrent mode I/O * i-ll*' 

747 contains status bits relating to DSR, CTS, CRX, and RCV on the 
R5-232-C port, and locations 74S and /49 hold nothing. 

Table I of APPENDIX 4 shows the definition of the error bits in 
location 747. The table gives each bit a decimal value which shows how 
that bit, if "on" or 1 (as opposed to ''off” or 0), adds to the total 
value of the bgte when interpreted as a decimal number. The meaning 
each of these error bits are discussed in APPENDIX 4, but first here 
is a BASIC example showing how you can check one of the bits: 


160 STATUS #1, IGNORED 
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170 LET ERRGRBITS = PEEK(746>/128 

180 IF INT(ERRGRBITS) O INTCERRORBITS+0.5) THEN PRINT "OVERRUN!" 

* f 


First the STATUS call i s mad e, and the status of the STATUS goes into 
the variable IGNORED (which tue don't check here—we assume the STATUS 
call itself is all right). Statement 170 takes the error bits from 
location 746 and divides it by twice the decimal number representing 
the bit being checked (as taken from Table I). In this casei we're 
checking for the BYTE OVERRUN error, whose number is 64. so we divide 
by 128. If the bit is 1. then the byte has a 64 in it. and after 
dividing by 128. the result has 1/2 (0. 5) in it. When tue add 0. 5 in 
the next Statement. ue add a 1 to the result of the second INT, The 
INTs not being equal thus means we have found a BYTE OVERRUN, If the 
error bit we r e not there. the 0.5 wo u 1 d add to 0 {in the 1/2 position) 
and the second INT would be equal to the first. 

APPENDIX 1 


WHAT IS R5-232-C2 


RS-232-C is a technical Standard of the Electronic Industries 
Association (EIA). Published in August of 1969, it is titled 
"Interface Between Data Terminal Equipment and Data C ommun i ca t i on 
Equipment Employing Serial Binary Data Interchange." The Standard 
specifies electrical Signal characteristics and names and defines the 
functions of the signal and control lines which make up a Standard 
interface. called RS-232-C. 


Figure 1 shows. diagrammatica 11y. the kind of hook-up that RS-232-C 

was designed to standardiie. A "DATA TERMINAL" is at each end of the 

communication link. The data terminal either generates or receives 
data (or does both). it could be a keyboard/screen "terminal" in the 
normal sense of the ward; it could be a Computer; and so on. The idea 
is that the data terminal is at the end of the communication 
link — hence "terminal. " However. the data terminal need not really be 
at the end—you may really want to think of "data terminal" as just 
the name of one of the two ends of an RS—232—C Connection. 

At the other end of an RS-232-C Connection is the "DATA SET. 11 In the 
example of Figure 1. each data set takes data from the data terminal 
it is connected to and sends/receives the data over the Communications 
link. The most familiär example of a data set is the MODEM, which 

takes data from a terminal and converts it for sending and receiving 

over a telephone line. 
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The ATARI Personal Computer System with the 850 Interface Module 
should be thougnt of as a unit comprising an RS-232-C Data TerminaJ 


FIGURE 1: COMMUNICATIONS HOOK-UP SHQWING ROLE OF RS-232 C 


DSR<->RTS 

CTS<->DTR 

data CR X DTR data 

terminal C- '■> set <■ / / I 1, 

(terminal) (modern) 


; data ' 

RS-232-C c otnmun i ca t i on RS232 

link link link 

(telephone) 

The data-set/data-termina 1 distinction should be kept in mind because 
the RS-232-C interface is DIRECTIONAL. That is, each line in an 
RS-232-C interface has a direction—one device drives the line (sends 
information) and the other receives the Information. Each line in an 
RS-232-C interface is defined as being driven by either the data-set 
end or the data-terminal end. 


RTS<—>DSR 
DTR<—>CTS 

data ->CR X data 

set C-> terminal 

(modern) (Computer) 


The RS-232-C Standard defines some 20 signalling lines or 

"circuits"/ as the Standard refers to them. Most of them are optional 

and rare 1 y used. Even u/ith many omissions and deviations from the 

Standard, a link may still be referred to as RS-232-C. It is more 

common to refer to the link loosely as ”Rb-232—C" or ”RS—232— 

compatible“. 

The most commonly used RS-232-C lines are given in Table 1. The table 
shoius the name of each 1 ine in the RS-232-C Standard and the common ly 
used mn emonic s. 
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TASLE I—THE MOST COMMON RS-232-C CIRCÜITS 


LINE DIRECTION DESCRIPTION 

NAME 


ABBREVIATION (CIRCUIT) 


BA terminal—>set Transmitted data XMT 

terminale—set Receiveddata RCVCA 

terminal—>set Request to send RTS C3 

TerminalC—set Clear to send CTS CC 

terminal<—set Data set ready DSR AB 


Signal ground CF terminale—set Signal (carrier) 
CRX CD terminal—>set Data terminal ready 


SB 


(none) 
d e tec t 
DTR 


It is most common practice to use common names or abbreviations for 
the RS—232-C Signals» and not the two-letter names in the official 
Standard. Thus the following happens: transmit and receive, for any 

given device, are RELATIVE TO THAT DEVICE. That is, data goes out of 
a device on XMT and comes in on RCV. Thus to connect tuo RS-232-C de- 
vices tuhen given the common names of the Signals, you should connect 
XMT to RCV (in one direction) and RCV to XMT (in the other direction). 
If one of the devices is uired as a data set and the other as a data 
terminal, then you should connect DTR to DTR, DSR to DSR, RTS to RTS, 
and so on. If, on the other hand, they are each uired as data term- 
inals, you should be careful how things are connected—more on this 
later. 


The Signal ground Connection must a1way s be made, (Notice that 
RS—c.32—C r e quir e s that the ground potential of the tuo devices be 
equal, that is, their grounds are connected. Devices for which this 
requirement cannot be met cannot be connected via an RS-232-C 
interface.) 

Data terminal ready is used by RS—232-C to allow the terminal to 
Signal its readiness to send or receive data. This is a Signal to 
auto-answer modems that they have permission tg answer the ringing of 
the telephone line. 

Data set ready is used by the data set to signal its readiness to send 
or receive data. This indicates that Communications are established. 

Request to send is used by the data terminal to teil the data set it 
wishes to send data. Some modems (Bell 102 for example) require this 
line to switch directions. 

Clear to send allows the data set to signal its readiness to pass data 
from the data terminal. 

The carrier detect line allou/s the data set to teil the data terminal 
that the communication link is established. This often differs little 
from data set ready, except that data set ready usually refers to 
'telephone off the hook" (answered) whereas carrier detect means 
something like 11 1 hear the modern at the other end and me can talk 
now. " When carrier detect goes OFF, data set ready OFF usually follous 
a fern seconds later, indicating that the other end has "hung up." 
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In normal Operation/ DTR, DSR, and CRX are all ON. For full duplex 
Operation RTS and CTS are also both ON. Hoiuever, it is often not 
necessary to have all these lines be ON— either one or the other 
devices on the RS-232-C Connection does not have all the lines, or it 
is ÜK to ignore them (one of the properties of the RS-232-C Standard 
is that not all of it needs to be implemented—it's perfectly OK to 
lsave parts out), To operate the ATARI S30 Modem, for instance, none 
of the control lines need to be used. In fact, the ATARI S30 Modem 
ignore; DTR and RTS, and it turns DSR, CTS and CRX on and off together 
(tuith carrier). 

Note that the communication link shoun in Figura 1 is not defined by 
RS-232-C. In particular, this link seldom has more than the 
" e qu i va i en t" cf XMT and RCV—that is, only data lines and no control, 
Hotuever, as often as not this link is a full duplex link, so data can 
go both wag; s iitiu 1 t anecus 1 y. ASCII oharacters are the most common 
data sent, so the data sent each i±>ay can be either "control" data or 
“data" data. 

With full duplex Operation, ttuo devices can "Handshake" tuith data in 
various ways. Common terminals usuaily do not have an internal 
connection bettneen the keybosrd and display (or they have a switch, 
usuaily called half/full duplex, to make or break this internal 
connection) so tuhen talking tuith a Computer in full duplex mode (the 
most common mode), the Computer at the other end "echoes" (sends back) 
each character to be displayed as it is typed. This allotus you to see 
exactly tuhat the Computer at the other end receives. It also allows 
the Computer at the other end to decide NOT to let you see tuhat you 
have typed, as in " sup pr es s i ng " the echo of a passtuord. 

Half duplex Operation means that someiuhere a! ong the c ommun ications 
path, data may pass only one direction at a time, Not all parts of 
the Communications path need be half duplex, but if eny part is, then 
the luhole System pretty much has to send data only one way at a time. 

In half duplex mode, the Computer at the other end does not echo back 
tuhat you type. In this case, in order to see uihat you type, the 
connection from keyboard to screen must be set locally, that is, set 
your terminal to "half duplex. " (Note: the ATARI TeleLink I terminal 

emulation cartridge does not have the äquivalent of a half/full 
switch. However, the ATARI 330 Modem does have such a switch, and 
wh en it is plaeso in the Half duplex position, it echoes any data sent 
out over the phone back to the ATARI Computer console. ) 

A common "handshake" that requires full duplex is the XGFF/XDN 
(transmit off/transmit on) handshake. The receiver of data can send 
XQFF to the senden to ask the sender to pause the data tränsmission, 
and XON to rssume. This allows the user of a screen terminal to stop 
the data so he can read the screen, and it allows a Computer which is 
receiving data from another Computer to effectively control the rate 
at which it can accept data. There are many variations of XGN and 
XQFF, including ACK/NAK and the BREAK signal, among others. 

RS~232"C compatibility has come to cover many devices which are not 
"data set;" or "data terminals", particularly in the personal Computer 
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world. What this usually means is that the device conforms to the 
ELECTRICAL RS-232-C specification, which is shown in Table XI. 
Sometimes such devices (which include printers; plotters, digitizing 
padsi and many other interesting devices) also haue lines which are 
called DSR, DTR» RTS and so on. but their use is often not covered by 
the RS-232-C Standard and usually the use is specific to the device. 
One such use is to Signal readiness to accept data fron your Computer 
(as opposed to sending XOFF/XGN over a data line>. UnfortunateIy, 
there is no Standard of how many characters after the line goes OFF 
that the device will acrept, nor a good way to determine where to 
start up again when the device becomes ready, You will have to 
familiariie yourself with your device 's characteristics and then 
program you ATARI 800/400 Computer and the 850 Interface Module 
atcordingly. 

TABLE 11 —RS-232-C ELECTRICAL SPEC IFICAT IONS 

TYPE OF SIGNAL FIRST STATE SECOND STATE 

-24 volts to -3 volts +3 volts to +24 volts 


Einar y sig na 1 
Signal condition 
Control function 


1 

MARK 

OFF 


0 

SPACE 
□ N 


It is common practica uhen using the 25—pin D connector most used with 
RS-232-C to connect XMT to pin 2, RCV to 3, RTS to 4, CTS to 5i DSR to 
6r common Signal ground to 7, CRX to 8, and DTR to 20. However, these 
conventions mag not be followed, and you may also run into cases where 
the other pins in the connector have either entirely unrelated 
functions (such as other types of communicat i on Standards on the same 
connector) or possibly related functions (such as setting the Baud 
rate by connecting two pins). READ THE INSTRUCTIONS OF ANY DEVICE YOU 
INTEND TO CONNECT TD THE ATARI S50 INTERFACE MODULE CAREFULLY! You 
may have to make your own cable to connect the device to the Interface 
Module, 


Selieve it or not, the RS-232—C Standard does not specify hou data 
should be transmitted on XMT and RCV. In facti RS-232-C explicitly 
avoids this issue. Fortunatelyi common convention and other Standards 
have settled on a pretty universal serial data transmission 
convention. When data is not being senti the data line sits idle in 
the MARK state, A data character (sometimes called a, transmission 
WORD) is signalied by one START BITi represented by the SPACE state. 

It is followed by the data bits (most commonly 8 of them), each bit 
being represented by SPACE for 0 and MARK for i. The word is 
terminated by 1 (sometimes 2) STOP BIT. represented by the MARK state. 
The next word can immediately follow with its start bit, but if it 
does not, the line stays idle in the MARK state (effective1y, the stop 
bit lasts indefinite1y ). The data bits are ordered least significant 
first, that is, the bit numbered 0 is sent first, 1 next, and so on. 
The receiver does not know when a character will be coming, so it has 




to constantly monitor the stopped MARK state looking for the 
transition to a start bit. The receiver can then receive the Test of 
the bits in the uiord because it knows ujhen each will arrive — each bit 
has the same duration as established by the SAUD RATE (bits-per-second 
rate) of the communication, Of coursei both the transmitter and 
receiver must use the same Baud rate. 

There are only a small number of common Baud ratesi and the ATARI 850 
Interface Module Supports all of the most common ones. The most common 
transmission ward size is 8 bits; when sending ASCII, which is a 7-bit 
code, the Bth bit usually represents the parity, is just set to 1 or 
0, or is used as a mark er bit of some sort. ASCII is very 
oc cas i ona11y sent in 7—bit words, The ATARI 850 Interface module 
supports 7-bit-werde for these cases, and can also be used for 
communication with 7-bit or 6-bit codes such as BCD Cwith or without 
parity). Five-bit words are also allowed so you can communicate with 
old Saudot-code teletypes for rad io-te1etype and similar uses. 
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